comment コメント code
お作法など
@param - 引数hoge
など
共通のお決まりをまとめ使いこなせるようにしとく
JSDoc
,
TSDoc
が参考になる
コメント付け加えるべきところ
1.公開されるAPI
2.トリッキーな実装
ソースコードのコメント率は20%を切ることが望ましい
Best practices for writing code comments - Stack Overflow Blog
ルール9個
どれくらいコメントを書くのか？